經過前兩天對 dotagent 和 ruler 的介紹，我們現在需要從技術角度深入比較這兩個 System Prompt 統一管理工具的核心差異。本文將聚焦於架構設計、功能特性和技術實現的對比分析，為後續的工具選擇奠定基礎。

一、核心架構與設計理念對比

1.1 檔案組織哲學差異

dotagent 的模組化檔案架構：

.agent/
├── core-style.md
├── api-safety.md
└── frontend/
    └── components.md

dotagent 採用統一的 .agent 目錄結構，每個 .md 檔案都支援 YAML frontmatter 提供基礎的元資料控制，支援巢狀資料夾組織。

ruler 的階層化目錄架構：

.ruler/
├── AGENTS.md           # 主規則檔案
├── coding_style.md     # 附加規則檔案
├── api_conventions.md  # 專門化規則
└── ruler.toml         # 統一配置檔案

ruler 採用簡潔的目錄結構，透過檔案名稱和巢狀目錄來表達規則關係，強調簡單直觀的管理方式。

1.2 配置複雜度比較

dotagent 的基礎 YAML 控制：

---
id: core-style
title: Core Style Guidelines
alwaysApply: true
priority: high
scope: "src/**"
---

# 核心程式碼風格指南

## 開發規範
- 使用 TypeScript 進行開發
- 遵循 ESLint 規範
- 所有非同步函數都必須處理錯誤

ruler 的簡潔化配置：

# TypeScript 開發規範

## 程式碼風格
- 優先使用 `interface` 定義物件型別
- 使用 `type` 定義聯合型別或複雜型別運算
- 避免使用 `any`，必要時使用 `unknown`

## 測試要求
- 所有函數都必須有完整的 TypeScript 型別定義
- 使用 ESLint 和 Prettier 的推薦配置

# ruler.toml
default_agents = ["copilot", "claude", "aider"]

[agents.cursor]
enabled = true
output_path = ".cursor/rules/ruler_cursor_instructions.mdc"

[agents.claude]
enabled = true
output_path = "CLAUDE.md"

技術分析：

• dotagent 提供基礎的元資料控制，支援 id、title、priority、scope 等字段
• ruler 追求配置簡潔性，透過 TOML 檔案統一管理平台設定

二、功能特性深度對比

2.1 平台支援範圍比較

2.2 核心功能比較矩陣

三、跨目錄規則載入：ruler 的技術創新

3.1 巢狀規則架構解析

ruler 的跨目錄規則載入是其最重要的技術創新，這與 dotagent 的單目錄組織方式形成鮮明對比：

# ruler 支援的複雜專案結構
project/
├── .ruler/                 # 全域專案規則
│   ├── AGENTS.md          # 基礎開發規範
│   └── security-rules.md  # 安全規範
├── src/
│   ├── api/
│   │   └── .ruler/        # API 層特定規則
│   │       └── api-conventions.md
│   └── frontend/
│       └── .ruler/        # 前端特定規則
│           └── react-standards.md
└── tests/
    └── .ruler/            # 測試特定規則
        └── testing-practices.md

技術實現機制：

# ruler 的巢狀載入演算法
ruler apply --nested --verbose

# 執行過程：
# 1. 掃描專案目錄樹，發現所有 .ruler/ 目錄
# 2. 按照目錄深度排序，深層目錄優先級較高
# 3. 合併所有規則檔案，添加來源標記
# 4. 生成最終的統一規則檔案

3.2 巢狀載入實際效果展示

最終生成的統一規則檔案內容：

--- Source: .ruler/AGENTS.md ---
# 全域開發規範
- 使用 TypeScript 進行開發
- 遵循 ESLint 規範

--- Source: src/api/.ruler/api-conventions.md ---  
# API 開發特定規範
- RESTful API 設計原則
- 使用 OpenAPI 規範

--- Source: tests/.ruler/testing-practices.md ---
# 測試開發規範
- 測試覆蓋率不低於 80%
- 使用 Jest 作為測試框架

3.3 dotagent 的檔案組織對比

dotagent 支援 .agent/ 目錄下的巢狀資料夾組織，但這只是單一目錄內的檔案組織，例如：

.agent/
├── core-style.md
├── frontend/
│   └── components.md
└── backend/
    └── api-rules.md

關鍵技術差異：

• dotagent：單目錄內的模組化組織
• ruler：跨越專案多個目錄的上下文感知規則載入

四、私有規則管理機制對比

4.1 dotagent 的私有規則實現

多種私有規則標識方式：

<!-- 方式一：檔案名後綴 -->
<!-- my-preferences.local.md (自動排除) -->
---
id: my-preferences
---
# 我的個人偏好
- 使用 4 空格縮進
- 偏好箭頭函數

<!-- 方式二：private 目錄 -->
<!-- .agent/private/client-specific.md (自動排除) -->
---
id: client-rules
---
# 客戶特定需求
- 特殊的 API 金鑰管理
- 客製化錯誤處理

自動 .gitignore 管理：

# dotagent 自動生成的忽略規則
.agent/**/*.local.md
.agent/private/**
.github/copilot-instructions.local.md
.cursor/rules/**/*.local.mdc
.clinerules.local
.windsurfrules.local
.rules.local
CLAUDE.local.md

4.2 ruler 的私有規則處理

ruler 不提供專門的私有規則機制，需要手動管理：

# 手動將私有規則添加到 .gitignore
echo ".ruler/private-rules.md" >> .gitignore

# 或者使用分離的配置檔案
ruler apply --config ./team-config/ruler.toml  # 團隊配置
ruler apply --config ./personal/ruler.toml     # 個人配置

技術分析：

• dotagent 的私有規則機制更系統化和自動化
• ruler 需要手動流程來處理私有內容

五、MCP 伺服器管理：ruler 的企業級功能

5.1 ruler 的 MCP 統一管理

TOML 配置格式：

# ruler.toml 中的 MCP 設定
[mcp]
enabled = true
merge_strategy = "merge"  # 或 "overwrite"

# 本地 stdio 伺服器
[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]

[mcp_servers.filesystem.env]
API_KEY = "your-api-key"

# 遠端伺服器
[mcp_servers.search]
url = "https://mcp.example.com"

[mcp_servers.search.headers]
Authorization = "Bearer your-token"

支援的 MCP 配置檔案：

• Claude Code: .mcp.json
• VS Code Copilot: .vscode/mcp.json
• Cursor: .cursor/mcp.json
• Amazon Q CLI: .amazonq/mcp.json
• 其他平台的對應配置檔案

5.2 dotagent 的 MCP 支援情況

dotagent 目前不支援 MCP 伺服器的統一管理，這是其與 ruler 的重要差異之一。如需 MCP 功能，需要手動為每個平台分別配置。

結語

透過深入的技術對比分析，我們可以清楚看到兩個工具的核心差異：

dotagent 的技術特色：

• 基礎化控制：YAML frontmatter 提供基礎的元資料管理
• 私有規則系統：完整的自動化隱私保護機制
• 模組化架構：適合複雜的規則組織和管理
• 元資料驅動：透過配置控制行為，靈活性較高

ruler 的技術特色：

• 巢狀規則載入：獨有的目錄階層感知能力
• MCP 管理：統一的 Model Context Protocol 伺服器配置
• 簡約設計哲學：最小化配置，最大化自動化
• 更廣泛的平台支援：涵蓋 25+ 種 AI 編程工具